SoupKitchen 1.0
(C)1995 Innovative Computer Solutions, All Rights Reserved
Written by Dan Rowley, Documentation by Tom Collins

< Overview >
SoupKitchen is a full-featured soup browser/editor for the Newton. 
Shareware, $10.  Free to NewtCase 2.x users.

< Disclaimer >
ICS assumes no responsibility for whatever damage you do with SoupKitchen. 
When making changes, you should know what you're doing.  Be extra careful
with the System soup.  If you delete or change important entries, you may
have to completely reset your Newton.

< Instructions >
Upon launching SoupKitchen, you will be asked to select a soup to edit. 
Once selected, SoupKitchen will provide information on that soup (number of
entires, storage used, index slot, etc.).  Tap on the Browse button to
enter the soup browser.

While editing, it's important to understand the structure of soups and how
SoupKitchen displays their contents.  A soup is a linked list of entries. 
Each entry is a frame.  Each frame contains slots.  A slot can be an
integral value (character, string, integer, real, boolean, symbol, etc.),
an array of slots, or another frame.  SoupKitchen displays each frame in
its own browser.  When you click on a slot in a frame, SoupKitchen will
respond in one of two ways.  If the slot is an integral value, SoupKitchen
will load an editor for that slot (except for binary objects which the
current version of SoupKitchen cannot handle).  If the slot is an array or
another frame, SoupKitchen will open another browser below the current one
and display the new frame in it.

< User Interface >
From the main screen, there are various buttons to help you navigate
through the soup:

At the top of the screen is a button with the name of the current soup. 
Tap on the button to go back to the soup list.

Below the button is a status indicator that tells you which entry you're
browsing, and the total number of entries in the soup.  The prev/goto/next
buttons let you traverse the entries in the soup.

Each frame of the soup is presented in a browser on an endless roll.  You
can scroll through the slots in a frame's browser by using the up and down
arrows on the right side of the browser.  You can resize the height of the
browser using the gray box in the lower-right corner of the browser.  You
can scroll through the endless roll of browsers using the
silk-screened/built-in arrows at the bottom of the display.

< Routing Options >
Remove Soup - removes the soup you're browsing
Rename Soup - asks you for a new name for the soup
Copy Soup - lets you make another copy of the soup with a new name
Copy Soup to <storename> - lets you make a copy of the soup on the named
store
Remove Entry - removes the current entry from the soup
Remove Slot - removes the last selected slot (closest to bottom of roll)

< Info >
About SoupKitchen - displays credits screen
Make dummy soup - creates a soup called "dummysoup" that you can experiment
with

< Technical Info >
SoupKitchen supports calls from other programs to open a particular soup
(for example, our package management utility, NewtCase, can use SoupKitchen
to browse a selected soup).  If you would like to support this call in your
programs, contact Dan Rowley at dan@newts.com.

SoupKitchen reports that some soups "contains <items> for <package>".  When
a program creates a union soup, it provides the Newton OS with a symbol for
the soup and two words (one singular, one plural) describing the contents
of the soup.  SoupKitchen uses this information, which is stored in the
info frame of the soup, to display the "contains"Jmessage.

< Registration Information >
This application is SHAREWARE.  If you decide to keep it, please register
by sending US$10.00 to Innovative Computer Solutions; ATTN: Tom Collins;
1075 North Miller Road, #142; Scottsdale, Arizona USA 85257-4612.  Please
include your name, the name of this utility (SoupKitchen 1.0), address
(postal) and preferred e-mail address so we can contact you about updates
and our other products.

You can register by credit card through Kagi Shareware services.  E-mail us
to request a copy of the registration program, or connect to our WWW page
<http://www.newts.com/register.html> or FTP directory
<ftp://ftp.newts.com/pub/register/> to download it.  You can also register
SoupKitchen on CompuServe.  GO SWREG and search for apps with the keyword
"ICS" to see all of our programs.  (at this time, SoupKitchen has not been
assigned an SWREG number).

Or, you can order our "NewtCase & Essentials" utility package and get
NewtCase 2.2, SleepAid, NewtInfo, SoupKitchen and GestureLaunch/Script. 
It's only $49.95 from PelicanWare (503/221-1148).

If you have registered any previous version of SoupKitchen, you are
automatically registered for this version.  Owners of NewtCase 2.0 and
later are also registered for this version.

PLEASE BE HONEST and register this software if you use it -- we can't
continue to write cool Newton apps if we don't get any support.  We
deliberately priced SoupKitchen where anybody can afford it.  Ten dollars
really isn't that much, but it means a lot to us - please don't violate our
trust by failing to register your shareware.

< Bugs, Questions, Comments, Suggestions... >
Send e-mail to the author, Dan Rowley, at dan@newts.com.  For business
messages (e.g., registration questions), please write tom@newts.com.  You
can also get general information by e-mailing info@newts.com, or find out
what we're up to by mailing news@newts.com.  We want to develop Newton
applications to fit YOUR needs.  Give us feedback, let us know if we're
doing it right.  We're here for you.

< Our Other Newton Applications >
Check out our popular Newton utilities, NewtCase and SleepAid.  They were
voted numbers three and five (respectively) in the GNUT Top 10 Shareware
List of September 1994.  We're also responsible for HeapIt, NewtInfo,
Newt21, ICS Fixer, GraffitiPatch, GestureLaunch, SoupKitchen, inLine and
PrefsPatch.

You can find our software on CompuServe (GO NEWTON), AOL (PDA and NEWTON),
AppleLink, eWorld, and the Internet (newton.uiowa.edu, ftp.amug.org, etc.).
 Internet users should check out our World Wide Web page at
http://www.newts.com/ and FTP files (always the latest versions) at
ftp://ftp.newts.com/pub/.

< Legal Mumbo Jumbo >
Newton, MessagePad, Connection Kit and Apple are registered trademarks of
Apple Computer, Inc.  SoupKitchen is a trademark of Innovative Computer
Solutions.

You can't sell SoupKitchen, but you can charge a nominal fee for connect
time or media (not to exceed $5).  Contact the authors if you plan to
include it in some sort of shareware/freeware collection or bundle it with
a commercial product.

In using this software, you understand and agree that this software is
provided "as is" without warranty of any kind.  The authors do not make any
warranties, either expressed or implied, including but not limited to
implied warranties of merchantability and fitness for a particular purpose,
with respect to this software.

In no event shall the authors be liable for any consequential, incidental,
or special damages whatsoever (including, without limitation, damages for
loss of critical data, loss of profits, interruption of business and the
like) arising out of the use or inability to use this software.

Have a nice day.  ;-)

Innovative Computer Solutions / (602) 970-1032
1075 N. Miller Rd. #142 / Scottsdale, Arizona USA 85257
Dan Rowley/dan@newts.com/CIS: 73563,2343/eWorld: DRowley
Tom Collins/tom@newts.com/CIS: 75460,2121/eWorld: Innovative